![]() |
RetrievePictInfo |
||||
Header: | PictUtils.h | Carbon status: | Supported | |
Returns information about all the pictures, pixel maps, and bitmaps included in a survey.
OSErr RetrievePictInfo ( PictInfoID thePictInfoID, PictInfo *thePictInfo, SInt16 colorsRequested );
The ID number, returned by the NewPictInfo function, that identifies the survey of pictures, pixel maps, and bitmaps.
On return, a pointer to the PictInfo structure that holds information about the pictures or images in the survey.
This function also collects information from black-and-white pictures and bitmaps, and is supported in System 7 even by computers running only basic QuickDraw. However, when collecting color information on a computer running only basic QuickDraw, the function returns NULL instead of a handle to a Palette or ColorTable structure.
From 1 to 256, the number of colors you want returned in the ColorTable or Palette structure included in the PictInfo structure.
A result code.
After using the NewPictInfo function to create a new survey, and then using RecordPictInfo to add pictures to your survey and RecordPixMapInfo to add pixel maps and bitmaps to your survey, call RetrievePictInfo.
When you are finished with the information in the PictInfo structure, dispose of the Palette structure by using the DisposePalette function. Dispose of the ColorTable structure with the DisposeCTable function. Dispose of other allocations with the DisposeHandle function. Use the DisposePictInfo function to dispose of the private data structures created by the NewPictInfo function.
The RetrievePictInfo function may move or purge memory.
Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.
© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)